###User Defined Function###
_GDIPlus_GraphicsMeasureCharacterRanges

###Description###
Gets a set of region objects each of which bounds a range of character positions within a string

###Syntax###
#include <GDIPlus.au3>
_GDIPlus_GraphicsMeasureCharacterRanges ( $hGraphics, $sString, $hFont, $tLayout, $hStringFormat )

###Parameters###
@@ParamTable@@
$hGraphics
	Pointer to a Graphics object
$sString
	The string to measure
$hFont
	Pointer to a Font object that specifies the font characteristics
$tLayout
	$tagGDIPRECTF structure that defines the string boundaries
$hStringFormat
	Pointer to a StringFormat object that specifies the character ranges and layout information, such as alignment, trimming, tab stops, and so forth
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	an array of region objects:
		[0] - Number of regions
		[1] - Region 1
		[2] - Region 2
		[3] - Region 3
Failure:	sets the @error flag to non-zero, @extended may contain GPSTATUS error code ($GPIP_ERR* see GPIPlusConstants.au3).
@@End@@

###Remarks###
If the function succeeds, it's the responsibility of the user to release these regions.

###Related###
$tagGDIPRECTF, _GDIPlus_GraphicsMeasureString, _GDIPlus_RegionDispose

###See Also###
@@MsdnLink@@ GdipMeasureCharacterRanges

###Example###
@@IncludeExample@@
